Skip to content

Conversation

Copilot
Copy link
Contributor

@Copilot Copilot AI commented Oct 1, 2025

Description

Fixes #23209 by clarifying which Azure Storage package is used in the F# Blob Storage documentation.

Problem

Users were encountering confusion when following the F# Azure Blob Storage tutorial. The documentation referenced "Azure Storage Client Library for .NET" which is vague and could refer to either:

  • The deprecated WindowsAzure.Storage or Microsoft.Azure.Storage.Blob packages
  • The modern Azure.Storage.Blobs package

This ambiguity led users to try the deprecated packages and encounter deprecation warnings, causing confusion about whether the tutorial was up-to-date.

Changes

This PR makes minimal, targeted updates to clarify package usage:

Documentation (docs/fsharp/using-fsharp-on-azure/blob-storage.md)

  1. Explicitly names the package: Changed "Azure Storage Client Library for .NET" to "Azure.Storage.Blobs package" in the introduction to remove ambiguity.

  2. Adds deprecation guidance: Inserted an IMPORTANT callout that:

    • Confirms the article uses the modern Azure.Storage.Blobs package
    • Explicitly names the deprecated packages (WindowsAzure.Storage and Microsoft.Azure.Storage.Blob)
    • Points users to migration guidance if they're updating from old code
  3. Improves clarity: Fixed minor grammar issues in the "Add packages in a script" section.

  4. Updates date: Updated ms.date to 10/02/2025 to reflect the content revision.

Code Sample (samples/snippets/fsharp/azure/blob-storage.fsx)

  1. Adds clarifying comment: Added a comment at the top of the sample file explicitly stating it uses the modern Azure.Storage.Blobs package and warns against using deprecated packages.

Validation

  • ✅ Markdown linting passes with 0 errors
  • ✅ Code snippets use the correct Azure.Storage.Blobs package and namespaces
  • ✅ Tested compilation of F# code with Azure.Storage.Blobs package version 12.25.1
  • ✅ Sample file comment matches article description

Impact

This change helps users by:

  • Immediately clarifying which package to install
  • Preventing confusion for those migrating from older tutorials
  • Providing clear guidance for users with deprecated package references
  • Ensuring consistency between documentation and code samples
Original prompt

This section details on the original issue you should resolve

<issue_title>Microsoft.WindowsAzure.Storage</issue_title>
<issue_description>
I get the message: The package has been deprecated.
When I try Azure.Storage.Blobs the code on this page doesn't work.


Document Details

Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

Comments on the Issue (you are @copilot in this section)

Fixes #23209

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.


Internal previews

📄 File 🔗 Preview link
docs/fsharp/using-fsharp-on-azure/blob-storage.md Get started with Azure Blob Storage using F#

@dotnet-policy-service dotnet-policy-service bot added the okr-quality Content-quality KR: Concerns article defects (bugs), freshness, or build warnings. label Oct 1, 2025
@Copilot Copilot AI changed the title [WIP] Microsoft.WindowsAzure.Storage Clarify Azure Blob Storage F# documentation uses modern Azure.Storage.Blobs package Oct 1, 2025
@Copilot Copilot AI requested a review from BillWagner October 1, 2025 13:23
Copilot finished work on behalf of BillWagner October 1, 2025 13:23
@BillWagner
Copy link
Member

@copilot this is a good start. Two more tasks to complete:

  • Update the referenced sample, included via snippets to match the updated article description.
  • Update the date to today's date.

Copy link
Contributor Author

Copilot AI commented Oct 2, 2025

@copilot this is a good start. Two more tasks to complete:

  • Update the referenced sample, included via snippets to match the updated article description.
    ...

Done in commit 2eb6209. Added a clarifying comment at the top of blob-storage.fsx and updated the ms.date to 10/02/2025.

Copilot finished work on behalf of BillWagner October 2, 2025 13:03
Copy link
Member

@BillWagner BillWagner left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is ready for final review.

@BillWagner BillWagner marked this pull request as ready for review October 2, 2025 17:12
@BillWagner BillWagner requested review from a team as code owners October 2, 2025 17:12
@BillWagner BillWagner requested a review from IEvangelist October 2, 2025 17:12
@T-Gro T-Gro merged commit cd7e8c2 into main Oct 3, 2025
10 checks passed
@T-Gro T-Gro deleted the copilot/fix-ab8d38f0-f616-4ab9-8315-24d612e35e2b branch October 3, 2025 06:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
dotnet-fsharp/svc okr-quality Content-quality KR: Concerns article defects (bugs), freshness, or build warnings.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Microsoft.WindowsAzure.Storage
3 participants